home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / patches / hsmoda07 / setter.tos / setter.eng < prev    next >
Text File  |  1995-01-22  |  5KB  |  141 lines
  1. SETTER.TTP
  2. **********
  3.  
  4. The small ASCII-files containing the configuration of many programs I
  5. don't like. These files have the advantage of an easy changability by
  6. using a text editor but the disadvantage of laying around in the
  7. directory and being not on the right place.
  8.  
  9. That's why I placed the configuration direct in the program. I added a
  10. short explanaition to every point. These explainations don't stay
  11. resident in my resident programs, no problem for an assembler programmer.
  12. The configuration of such programs is changed by using SETTER which reads
  13. the information and explaination and saves the configuration in the
  14. program again.
  15.  
  16.  
  17. Usage
  18. -----
  19.  
  20. From TOS1.04 up the use of SETTER is simple: Take the program to modify
  21. with the mouse and drag it on SETTER.TTP. SETTER will start, load the
  22. programm and start the configuration dialog or give a message, that
  23. configuration is impossible because the program doesn't contain any
  24. settings. For older versions of TOS: doubleclick SETTER.TTP and enter the
  25. name and path of the program in the appearing dialog box. SETTER
  26. recognizes with high safety whether the program contains a settings.
  27.  
  28. SETTER displays one setting after the other and waits for a new value for
  29. this setting. After every input the Return key has to pressed. The last
  30. question of SETTER is whether or not to save the changes.
  31.  
  32. SETTER gives some error messages if errors occur.
  33.  
  34. SETTER displays _its_ messages in German and English. The explainations
  35. in the programs SETTER displays only in the language in which they are.
  36.  
  37.  
  38. Copyright
  39. ---------
  40.  
  41. SETTER.TTP may be freely copied together with this text. The C-source may
  42. only be copied together with SETTER.TTP and SETTER.TXT.
  43.  
  44. Certainly anything that happens (or doesn't) by the usage of SETTER.* is at your
  45. own risk.
  46.  
  47. Maybe others (e.g. coders) think SETTER ist useful. Well, you may use it, but:
  48. If anyone releases an enhanced version of SETTER he has to follow these rules:
  49. - it must be freely distributeable too.
  50. - it must be noted that it is free and made by you, not me.
  51. - send me a mail (or better a copy of the program) - but don't let me cost that
  52.   anything
  53.  
  54. I don't like my specifications changed. Enhancements are allowed, but don't
  55. change existing commands!
  56.  
  57. A big hello to Wolfgang Wander - without him, who debugged this C-coding attempt
  58. of mine, I should have written it again - in assembly).
  59.  
  60. 'Me' is:
  61. Harun Scheutzow
  62. You can contact me as follows:
  63. Internet: Harun_Scheutzow@b.maus.de
  64. MausNet:  Harun Scheutzow @ B
  65. SnailMail: Harun Scheutzow
  66.            Dresdener Strasse 83
  67.          D-10179 Berlin
  68.            Germany
  69.  
  70. You use SETTER on your own risk!
  71.  
  72. GEM-Version of SETTER
  73. ---------------------
  74.  
  75. To create it faster and smaller I coded SETTER as TTP. Markus Kohm thought
  76. SETTER is a good idea and made a GEM-version having some more functions. This
  77. program is available from several BBS's. Search for SETTER.ZIP, e.g. in Maus KR.
  78. Actual dates of this BBS are:
  79. Phone number: 0721-358887
  80. Access times: 8am to 6pm and
  81.               8pm to 3am
  82. You can contact Markus at the following (Internet) address:
  83. Markus_Kohm@kr2.maus.de
  84.  
  85. Anyone planning to write other SETTER versions or needs more filetypes should
  86. take a look at this program first.
  87.  
  88. Versions
  89. --------
  90.  
  91. At startup SETTER will print the date of creation as yyyy-mm-dd and - I hope so
  92. - have more functions and less bugs.
  93.  
  94. 1993-11-27  String input implemented
  95. 1994-01-09  Inclusion of English output, minimum bugfixes
  96. 1994-05-07  Now runs with TOS 4.xx (Falcon)
  97.  
  98.  
  99. (People only using this package need to don't read on)
  100. Specifications for saving of editeable informations in programs
  101. ---------------------------------------------------------------
  102.  
  103. Harun Scheutzow, Nov. 21st, 1994
  104.  
  105. Modification is made by a SETTER .TTP, wich edits the program where are changes
  106. to be made in.
  107.  
  108. The zero-terminated string 'hAruNs cONfigER' can be found on an even address in
  109. the TEXT- or DATA-segment. It's length is - with the 0-byte - exactly 16 chars.
  110. Behind it is a LONG-pointer to the string's beginning.
  111. This looks - in assembly - like this:
  112.  
  113.       .even
  114. hkbg:
  115.       .dc.b "hAruNs cONfigER",0
  116.       .dc.l hkbg
  117.  
  118. After that the objects (made of text to be printed, config and place for config)
  119. can be found as a list.
  120.  
  121. The text to be printed is a C-string (this means 0-terminated) and filled with a
  122. 0-byte to the next even address if needed. An empty string (only 0-bytes) shows
  123. the object's list end.
  124.  
  125. The command for configuration is a WORD (16bit). It's values in the highbyte
  126. are:
  127.  
  128. 0
  129. Yes/No-setup: The following WORD will be set to $FFFF for yes and $0000 for no.
  130.  
  131. 1
  132. List for a LONG-input: The number of elements in the list stand in the lowbyte.
  133. The LONGS after that will be set to the 32bit integer given to input. If a
  134. place is invalid the value is $80000000.
  135.  
  136. 2
  137. String-input: The maximum length of the input string (including the 0byte at the
  138. and) stands in the lowbyte. This lenght has to be even. The string given to
  139. input is put right after this and will be filled to maximum with 0bytes.
  140.  
  141. ---EOF---